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PREFACE 

Pico is a cjrnphics package for people who want to write interactive 
graphical pronrans, and for people who have pronrnms to which they would 
like to add graphical input/output. At present only BCPL programs may 
call thQ Pico package, but versions for use with INTERLISP and Smalltalk 
arc on the way. Pico can bo used with the following hardware systems: 

(a) Any standard Alto, preferably v/th 64K. memory; 

(b) Don Laws* run-code display and its parent Alto; 

(c) The color graphics Nova system. 

Pico can handle Inputs from mice and tablets; it can generate graphic 
hardcopy with the aid of the XGP. 

About this vwnual 

You will find that this manual consists of four sections: 

I: An introrfuction, where some of the essential features of Pico are 
explained with the aid of examples. Everyone should read this 
section. 

II: A concise description of the basic Junctions of Pico. This section 
sliould also bo read by every potential user. Once you have read it, 
you should be able to write your first program using Pico. 

Ill: Instructions on how to use Pico -- where to find the necessary 
files, what to load with your compiled program, and so forth. You 
will need to read this section in order to run your program. 

IV: A description of the more advanced features of Pico. You won't need 
those unless you wish to manipulate curves, perform special 
transformations, or construct special input schemes. 

At the end are several Appendices, describing the free storage system and 
floating point routines that are integral to Pico, the online character 
recognizer, and the formats of font and hard-copy files used by Pico. 

Wo hope this arrangement of the manual is agreeable to all. Some readers 
may need additional background information; if so, they will find some 
useful references in the Bibliography. Comments about Pico and about this 
manual will bo gratefully received by the authors. 

Acknowledgements 

Pico was designed and implenented by the following members of the Graphics 
Systems Group: Patrick Baudelaire, Mike Cole, Bob Flcgal, William Wcwman, 
Dick Shoup and Bob Sproull. Figures 3, 8 and 9 in this manual were drawn 
by Bob Flcgal with the aid of Smalltalk. 
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SECTION I: INTRODUCTION 



Pico contains functions both for generating graphic output on a display 
screen or on the XGP, and for handling graphic inputs from a tablet or 
mouse. These two classes of function, input and output, are kept almost 
completely separate. Wo believe programmers will find this separation 
convenient. Wo also think it is easier to explain Pico by treating input 
and output separately: we will discuss output first. 

Pictures gonorated by Pico are made up of basic entities of three kinds, 
linos, curves and text; areas enclosed by lines and curves may bo filled 
with a uniform gray level or, if you have the hardware to do so, with a 
color. The functions that define these basic entities are called 
primitive functions . One can think of those functions almost as if they 
add linos, curves and so forth directly to the information on the screen. 
This is not quite true, however. Instead the information is deposited in 
a display file; the screen is not updated from the display file except 
when the function UPDATE is called. Thus you can obtain a simplified view 
of tho organization of the system by studying Figure 1, ignoring the light 
gray boxes. 
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Since v/e are dealing with filled areas, it is possible for graphical 
enities to overlap. Where two or more entities overlap, a simple rule 
determines what is seen; the thing most recently added to the display file 
is always visible, and may hide things added less recently. Thus to 
display text on a gray background, one calls the primitives to generate 
the gray area, then calls the text-display function. This is illustrated 
in the example that follows. 

The display file is not just a simple list of graphical primitives: it can 
be divided into segments. The use of segments has two major advantages: 
it permits individual parts of the picture to be changed independently of 
each other, and it allows things to overlay each other independently of 
execution sequence. The functions for manipulating segments include 
routines to create new segments, replace segments, delete them, add to 
them and change tho order in which they are overlaid. Note that none of 
those functions has any immediate effect on what is visible on the screen: 
after the appropriate changes to the display file have been made, the 
UPDATE function must be called to cause the screen picture to change. 
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Prinitivn functions allow pictures to be dofinod in screen coordinates . 
On a standard Alto display, for cxanplo, the screen coordinate system 
places (0,0) at the bottom left-hand corner of the screen, and (605,799) 
at tho top rirjlit. This is not always convenient. Transformation routines 
arc therefore provided so that parts of tho picture may be scaled and 
rotated, and so that the whole picture may be defined in a coordinate 
system indopendont of the particular display in use. Tho light gray boxes 
in Figure 1 show how transformation and segment-handling functions relate 
to tho rest of tho system. 

This completes our brief outline of the graphical output facilities for 
BCPL. The following example illustrates how they may bo used. It 
generates the "STOP" sign shov.n in Figure 2. Tho functions used in this 
cxanplo are described in more detail in Section II. 



GET "GSDEFS.SR" 

LET MAINO BE [ 
INITORAPfllCSO 
OPENSECi( 1) 

nOVETO(50,0) 

DRAWTO(50,200) 

SETCOLOR(GRAY) 
BEGINFILLO 



NOVETO( 0,200) 
DRAWTOC 0,275) 
l)RAWTO( 100,275) 
DRAWTOC 100,200) 
I)RAWTO( 0,200) 
ENDFILL( ) 
SETCOLOR( BLACK) 
MOVETO(35,230) 

DRAWTEXTC'STOP") 

CLOSESEGO 

POSTSEG(l) 

UPDATEO 



This file contains the definitions 
needed for tho use of Pico. 

Initializes the graphics system. 

This states our intention to begin 

creation of segment number 1. 

This sets tho current (x,y) position 

to the bottom of the post. 

This adds to the display file a line 

from (50,0) to (50,200). The current 

position becomes (50,200). 

This function sets the intensity of 

tho sign's rectangular area. 

This indicates the beginning of a 

"filled" area for the stop sign. The 

following MOVETO and DRAWTO commands 

specify the outline of the sign. 



Signals tho end of tho polygon. 
Specifies intensity for the STOP text. 
Specifics the starting position of tho 
text. 

Causes a text string to be added to 
the display file. 

Specifies the end of creation of 
segment 1 of the display file. 
Specifies that the contents of segment 
1 are to be shown on the screen the 
next time the screen is updated. 
Updates the screen by scan-converting 
tho information in all segments that 
havo been POSTed. 






SI 01' 
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Figure 2. 
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The next example shows the use of one of the graphic Input functions of 
Pico, use of the DIIAW function to perform simple transformations, and also 
shows how to gonorato graphic hard-copy. It uses Pico's online character 
recognizor. We assume that the recognizor has previously been "trained" 
to recognize two symbols, a triangle and the letter "P", and that a file 
SYMS.RC has been generated, containing the results of this training 
session. Now when the user draws a triangle, such as the example shown in 
Figure 3, a logic symbol for an inverter is added to the picture on the 
screen. When the user prints "P", a file is generated for producing XGP 
hard-copy. 



GET "GSDEFS.SR" 
LET MA1M( ) BE [ 
INJITORAPI!ICS( ) 
SETRECOGWIZERC'SYMS.RC") 



LET SN=0 
[ LET V=RECOGMIZE() 



SWITCHOM V>>EVENJT.CODE 
INTO [ 

CASE ST: 

SM=SNl-fl 

OPEMSEG(SN) 

DRAW( INVERTER. TRANSLATE 



CLOSESEG( ) 

POSTSEG(SN) 

UPDATE ( ) 

ENDCASE 
CASE SP: 

PLOTSEGSC'INV.XB") 

ENDCASE 
] 
] REPEAT 




Figure 3 



The recognizer tables are loaded from the file 

generated during the previous training 

session. 

Initialize the segment name sequence. . 

Wait for the user to draw a symbol, then 

return a vector containing information about 

the siin!)ol. 

The CODE entry in V contains the numeric code 
of the recognized symbol. 

The user drew a triangle (trained to return 
code "T") 

Create a now segment name. 
Start a nov/ segment. 
, V>>EVENT.XLEFT, V>>EVENT.YBOTTOM) 
Draw an inverter, using the procedure given 
below; position the symbol with its bottom 
left-hand corner aligned with the 
corresponding corner of the drawn symbol. 
Close the new segment. 
Add it to the list of posted segments. 
Update the screen picture. 

The user drew a "P" . 

Output a file IMV.XB for the XGP. 



] 



AND INVERTERO BE [ 



Repeat this loop endlessly. 



3 



Define the procedure to draw the Inverter 

symbol . 
MOVETO(0,0): DRAWTO(0,50); DR/vWTO( 50 ,25 ) 
DRAWTO(51,23); DRAWT0(53,23 ) ; [)R>\WTO( 54 , 25 ) 
DRAV/T0(53,27): DRAWTO( 51 , 27 ) ; DFJ\WTO(50 ,25) 
DRAWTO(0,0) 
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Figure 4 shows a typical plot gcnoratcd after a sequence of interactions. 












Figure 4 
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section; II: BASIC GRAPHICS FUhJCTIONS 

This section describes the basic functions of what may be called the 
kernel of Pico. Programs written using this kernel will work on all three 
classes of display mentioned above. Each display, however, has certain 
characteristics of its own: these arc mentioned as appropriate below. 

GRAPHI CAL OUTPUT -- Sognont-Handling Functions 

The display file is divided into scgricnts; each segment can bo thought of 
as an ordered collection of printlivo graphical entities. To create a 
socjnont, the progrannor "opens" a specific segment, specifics the 
primitive entities that (xrc to be added to the segnent, and then "closes" 
it. Each segnont is assigned a 16-bit "name" by the programmer; this name 
is used if later reference to the segment is necessary. 

A'otc well: none of the fol lowing segment-handling functions changes the 
image visible on the screen, 

OPEMSEG (segment-name). This function creates a new segment with the 
specified name. If a segment of the same name already exists, it 
will be replaced by the new segment. All subsequent graphical 
primitives arc addotj to this new "open" segment. Before opening the 
now segment, any other segment still open is closed. 

CLOSESEG (). This function closes the currently open segment. Any 
existing segment with this name is deleted. If no segment is open, 
CLOSESEG has no effect. 

DELETEJ;EG (segment-name). This function deletes the specified segment. 
If the specified segment does not exist, this function has no effect. 
DELETESEG never deletes the "open" segment. 

APPEMDSEG (segment-name). This function opens the specified segment for 
additions. All subsequent graphical entities are added to the end of 
the segment. If the specified segment docs not exist, APPENDSEG is 
equivalent to OPENSEG. 

POSTSEG (segment-name). This function adds the specified segment to the 
list of those that should be displayed on the screen. This list is 
called the "posted" list. If the specified segment is still open at 
the time of the POSTSEG call, it is closed before posting. Thus the 
sequence OPEMSEG, <graphical primitives), POSTSEG is sufficient. If 
the specified segment does not exist, this function has no effect. 

UNPOSTSEG (segment-name). This function removes the specified segment 
from the posted list. The graphical entities within the segment are 
unaltered. At some later time, the same segment may be posted again. 
If the specified segment does not exist, this function has no effect. 

RENAMESEG ( old-segment-name, ncw-segnont-name) . This function has no 
effect on the contents of the display file, but merely changes the 
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nano of the segment specified by "old-scrinont-niimc" to "ncw-scgmont- 
nano." If a scgncnt with nano "new-segmont-nnnG" already exists, it 
is doloted. If no segment naned "old-segrncnt-narno" exists, the 
REWAMESEG function has no effect. 

CLEARSEGS (). Deletes all segncnts in the' display file, includino any 
scgnont currently open. No changes are nado to the image on tho 
display screen. 

GRAPHICAL OUTPUT -- Updating tho Display 

UPDATE (). This is the onli/ function that causes tho screen to bo 
updated, other than PL0T3EGS which performs an UPDATE in tho process 
of generating a hard-copy file (r,oo below). If any segments have 
been altered (created, unposted, posted, deleted, etc.) since the 
previous call to UPDATE, the picture on tho screen is changed 
appropriately. 

Each graphical object in tho display file has a "priority" associated with 
it. V/hcn tho screen is UPDATED, it nay liappen that two distinct graphical 
objects may appear at the sano spot on the screen. In Figure 3, for 
example, tho characters "STOP" and pieces of the sign polygon fall on the 
same dots on the screen. In this case, the graphical object with the 
highest priority is displayed. Tho priority rule is very simple: 

- Within a segment, the priority order corresponds to the order in 
which tho graphical objects wore added to the segment; objects added 
last have highest priority and thus overlay objects added earlier. 
It is for this reason that the characters STOP take priority over the 
sign polygon. 

- Between segments, tho signed 16-bit integer name is used to decide 
priority; segment A overlays segment B if A > B. The RENAMESEG 
function is provided so that inter-segment priorities may be 
rearranged. 

GRAPHICAL OUTPUT -- Graphical Primitives 

Graphical primitives are used to specify straight and curved linos, 
polygons, filled curves (figures whose outlines are curves), and text. 
These entities are transformed, clipped, and then added to the currently 
open segment. The color or intensity of entities is defined with the 
SETCOLOR function. 

MOVETO (x,y) 

DRAWTO (x,y) 

Those functions specify the coordinates of line cndpoints; MOVETO 
sets tho "current position" to (x,y). DRAWTO draws a vector from the 
current position to (x,y) and then sets tho current position to 
(x,y). The coordinates are signed IG-bit quantities; since they will 
typically bo transformed (see below), tho coordinate system can be 
chosen by tho prograr:v;ior . 
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DRAWTEXT ("text-string") 

The spocified text string is displayed, starting at the current 
position, and then in subsequent Horizontal character positions. Note 
that no transformations are porformod on characters, other than the 
translation implied by setting the starting position with a HOVETO. 
A standard font is used unless the program indicates otherwise with 
the SETFONT function (see below). 

BEGIWFILL () 

ENDFILU () 

These functions permit MOVETO and DRAWTO functions to be used to 
specify a filled polygon. A simple example of polygon specification 
is BEG INF ILL MOVETO, DRAWTO, DRAWTO, DFIAWTO, ENDFILL. This would 
normally produce a three-sided polygon. If the locations specified 
by the initial MOVETO and the final DRAWTO do not coincide, however, 
Pico automatically inserts a DRAV/TO to close the polygon. The 
examples belov/ demonstrate this. 

"Holes" may bo specified inside polygons by means of several MOVETO, 
DRAWTO, DRAWTO, DRAWTO... sequences within one BEGINFILL, ENDFILL 
pair. Thus we can produce Figure 5 with the following statements: 

BEGINFILLO 

MOVETO(0,0); DRAWTO(20 ,40 ) ; DRAV/TO(40 ,0) ; 

MOVETO(10,10); DRAWTO(20,30); ,DRAWTO(30,10); 
ENDFILLO 
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Figure 5. 



Figure 6. 



The closed curves specified within one BEGINFILL, ENDFILL pair may 
cross, producing effects such as Figure 6, in which the inner 
triangle of Figure 5 has been displaced. 



SETCOLOR (gray-level) 

SETCOLOR (red-component, green -component, blue-component) 

The SETCOLOR function may be used with a single argument to set gray 
levels between (the default value, representing black) and 255 
(representing white). Three manifest constants, BLACK, GRAY (=127) 
and WHITE, may be used where appropriate. The effect of SETCOLOR 
will vary somewhat with different output devices: the color graphics 
system, if used in black-and-white mode, will generate 256 different 
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rjray lovols, tho nin-codo display produces 32, but tho XGP and the 
standard Alto display produce only Qight dot patterns of differing 
densities. Note that large black areas do not reproduce on the XGP. 

With three argunonts, SETCOLOR nay be used to generate colors on the 
color graphics system. Components must bo in the range to 255. 

SETBACKGROUND (gray-level). 

SETBACKGROUMD ( rod- conponont.groon- conponont, blue -component ) 

This function specifics the intensity of the background, i.e. the 
intensity that Is displayed where no graphical entity is visible. 
Values have the sane rangn and interpretation as in tho SETCOLOR 
function. Either WHITE (tho default value) or BLACK should bo used 
with the standard Alto display, to save memory. 

SETCOLOR and SETnACKGROUNn nay bo called at any point in the program. In 
certain situations their effect is deferred, however; SETCOLOR, if called 
after a BEGIMFILL, will take effect only after the corresponding ENDFILL; 
the effect of SETBACKGROUMD is seen only when UPDATE is next executed. 

GRAPHICA L OUTPUT -- Transformations 

The first example of Section I defined a picture entirely in the screen 
coordinate system. This system is always in effect unless the program 
specifics otherv/ise. There are three main reasons why you may wish not to 
use screen coordinates: 

1. You may wish to use symbols that are defined in local coordinates, 
and that are to be scaled, rotated or translated before they are 
displayed, like tho 'inverter' in our second example. 

2. You may wish to define pictures too big to fit on the screen, and 
then to select parts of such pictures to bo displayed at various 
enlargements. 

3. You may wish to write programs that are not affected by the 
different screen characteristics of the different displays. 

Pico includes a number of transformation functions that cater to these 
needs. To understand them, it is important to realize that Pico in fact 
allows you to look through a conceptual windoiu at a large page of 
graphical information. This page, and the rectangular window onto it, may 
use a coordinate system quite different from tho screen's. Normally one 
will define the window size with the SETV/INDOW function, before opening 
the segments on v/hich this window operates. V/hen Pico constructs a 
segment of display file, it transforms everything into the page coordinate 
si/stcm; then it 'clips' av.'ay everything lying outside tho window, and 
transforms the rest into screen coordinates. If, as in our earlier 
examples, SETWINDOW is not called, Pico uses default values that equate 
the page and screen coordinate systems. 

Symbols included in the page information must be transformed from their 
local coordinate system into page coordinates, and Pico provides a DRAW 



Pico Manual BASIC GRAPHICS FUNCTIOMS Page 13 



function to do this: DRAW uses tho notion of describing symbols as display 
procedures (soo Rcforonce 1). Essentially, every time a s^inbol is to be 
added to tho currently open scancnt, a call is nadc to DRAW, specifying 
(a) the nnno of the procedure defining the symbol, and (b) the 
transfornations to bo applied to tho symbol in order to place it correctly 
in tho page space. 

Tho full form of the DRAW function's calling sequence is as follows: 

DRAV/( procedure -nnno, procodurc-argl , procoduro-arg2, . . . 
SCALE, sx, [[sy, ] sv/, ] 
ROTATE, thnta, 
TRANSLATE, translation-x, translation-y) 

where : 

'proccdure-nano' is the nano of tho display procedure, and 
•procodurc-argl' etc., are its arguments, if any; 

sx/sw and sy/sw are the scale factors in tho x- and y- direction; 
if sy is omitted, the procedure is scaled by sx/sw in both 
directions, while if both sy and sw are omitted, sx is used as 
an integral enlargement factor in both directions; 

thcta is tho anti-clockwise rotation in degrees; 

translation-x and translation-y are translations in the x-and y- 
dircctions . 

Tho DRAW function assembles all the transformations together into a 
single matrix, combines this v/ith any existing transformation, and 
then calls tho named procedure. The resulting transformation is 
applied to all the primitives called by this procedure. When the 
procedure returns, DRAW restores whatever transformation was 
previously in effect, and then itself returns. This mechanism 
permits display procedures to include calls to other such procedures 
via tho DilAW function. 

The full form of tho DRAW calling sequence is rarely necessary. Any 
identity transformations may be omitted, and tho display procedure 
need not have arguments. If two or more transformations are given, 
thoy will effectively bo performed in tho order specified. Tho order 
given above, SCALE-ROTATE-TRAWSLATE, is tho normal sequence to use in 
transforming symbols. 

Tho SETWINIDOW function is called as follows: 

SETWIMDOW (xloft,ybottom,xright,ytop). 

This function defines a rectangular windoio onto the page information, 
using page coordinates. The bottom left-hand corner of this 
rectangle is at (xlef t.ybotton) , and the top right-hand corner is at 
(xright.ytop) . All information lying outside this window is excluded 
from tho displayed picture. 
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Tho fol lowing pronran illustrates the use of SETWINDOW and DRAW. It 
generates tho output shown in Fifjuro 7 overleaf. 

GET "CiSDEFS.SR" 

/■ 
LET MAHvKO BE [ 

INITGRAPHICS( ) 

SETV/IN1)0W( -750, -1000, 750, 1000) 

Sot up a v/indow 1500 x 2000 units, centered at 
tho origin of tho page coordinate space, 

OPF.NSEO(l) 

t)RAW( TRI A^JGLE . " 1 " , TRvW'Sl.ATf-: ,-100,100) 

Draw iliG TRIANGLE s^r.bol, positioned at (- 
100,100) and hiholod with tho figure "1". 

DRAW( TR I A\'G LE , " 2 " . SCALE ,2.3, TRA\SLATE ,200,200) 

Draw tho triangle at (200,200) at 2/3 full size, 
labeled "2". 

DRAW( TR I A^'G LE , " 3 " , SCALE ,6.4,3, ROTATE . 30 , TRA\'SLATE ,50,-600) 

Drav/ tho triangle, scaled by 2 and 4/3 in the x- 
and y-diroctions, rotated anti-clockv/iso through 
30 degrees, and positioned at (50,-600). Label 
this triangle "3". 

POSTSEG(l) 

UPnATE( ) 

] 

ANJD TRIANGLE(STR) BE [ Now define the TRIANGLE display procedure. 
MOVETO(0,0) 
nRAV/TO( 100,400) 
l)RAV/TO(200.0) 
r)RAWTO(O.O) 

PlOVETO(100,120) Position tho label. 

r)RAWTEXT(STR) 
] 
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GRAPMICAl. INPUT 

Three basic functions are provided by Pico for graphic input. The first 
accepts an (x,y) position fron the tablet stylus or nouso; the socond 
accepts a stroke generated in a single sweep of the stylus or mouse; the 
third accepts one or more strokes and attempts to recognize the character 
or synbol they represent. All three return x and y values converted to 
page coordinates . 

Whenever one of those functions is called, the progran waits until the 
stylus switch, or one of the nouso switches, is dnprossed and released by 
the user. The RECOGNIZE function waits an additional interval in case the 
user wishes to add nore strokes. The input data is then returned as a 
pointer to a vector, which nay be accessed with the aid of a BCPL 
structure provided for the purpose. Thus no input is ever received from 
these functions until the stylus or mouse switch has boon pressed and 
released. 

The three basic functions are as follows: 

READPOSITION (). After the stylus or mouse switch is released, this 
function returns a pointer to a vector (V, say), containing: 



in V>>EVENT.X' ) 
V>>EVENT.Y ) 

in V>>EVENT. SWITCH 



the page coordinates of the cursor 
when the switch v/as pressed. 

switch number (tablet always returns 1). 



READSTROKE (). While the stylus or mouse switch is depressed, a trail 
of 'ink' records the path followed; after the switch is released, the 
function returns a pointer to a vector V containing: 



in V>>EVENT.XLEFT 
V>>EVENT.VROTTOM 

in V>>EVENT.XRICiHT 
V>>EVENT,YTOP 

in V>>EVENT. STROKE 



) The page coordinates of the bottom 
) loft and top right corners of the 
) rectangle enclosing the stroke. 
) 

A pointer to another vector, containing in 
its first word a count N of the number of 
recorded points, and then N pairs of x and 
y coordinates recording in page coordinates 
the path of the stylus or mouse (see Figure 
8). V>>EVENT. STROKE is zero if the stylus 
or mouse did not move while the switch was 
depressed. 



Figure 8. 



V»EVErfr.STFCiK£ 
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RECOGNIZE (). This function continues to colloct strokes until tho 
switch remains roloasod for at least one second (a parameter that may 
bo altered, see Section IV). An attempt is then made to rocognize 
the str'okc or strokes by matching U\cm against somo predefined 
descriptions. RECOGMIZE returns a pointer to a vector V containing: 



in V>>EVENT.XLEFT 
V>>EVEMT.V BOTTOM 
V>>F.VFAT.XRIGHT 
V>>EVF.MT.VTOP 

in V>>EVENT.CODE 



in V>>KVENT.CO\'F 



) Tho page coordinates of tho 

) corners of tho rectangle 

) enclosing the character 

) (see Figure 9). 

The numeric code of tho recognized symbol 
(normally tho ASCII code in the case of a 
cliaractor ) . 

Tho confidence, in the range to 100, with 
which the symbol v/as recognized. 



Tho vectors in which input information is returned are provided by Pico, 
and thoroforo should not bo doclarod by tho user program. Note that thoso 
vectors are ro-uscd tho next time an input function is called, so the 
relevant information must be extracted before another input function is 
called. 



V»EVENT,YTCP 




V»EVEf\IT.YBOTTOM 



V»EVENT.XRIGHT 



Figure 9. 

Throo other functions are useful for input: 

HITDETECT (x,y [ ,x-toleranco,y-toleranco]) . This function is useful for 
determining what the user is pointing at. It checks each displayed 
entity for overlap with the rectangle whoso center is at (x,y) In 
screen coordinates, and v.hose "half-size" is x-toleranco by y- 
tolerance. If any entity overlaps, HITDETECT returns a pointer to a 
vector, V say, containing tho following information: 



in V>>HIT.SEGNAME 



The name of tho segment nearest to (x,y). In 
ambiguous cases, the highest name is returned. 



in V>>HIT.DX ) 



The horizontal and vertical distance from 
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V>>11IT.DY ) (x,y) to this nearest segment. 

If tolerance values are onittcd, HITDETECT uses the largest positive 
integer. If there is no overlapping entity, HITDETECT returns zero. 

SETRECOGNIZEF^ ( "filename" ) . This function sets up the tables used by 
the RECOGNIZE function, by reading in a file of the given name. 
Previously a file of this name should have been created by using a 
training program (see Appendix 3). An argument of zero will clear 
the tables. This function returns FALSE if no file was found, TRUE 
otherwise . 

CLEARINK. (). Clears the ink from the screen, by performing an UPDATE. 

HARD COPY 

PLOTwSF.GS ("filename") This function writes out a file for the XGP, using 
the current contents of the display file. Hard-copy nay bo produced 
by sending this file to any XGP Nnva, and then running the XPLOT 
program {Sq.q Section III). If no file name is given, unique names in 
the soquonco POO.XB, POl.XB, ... P99.XB are used. PLOTSEGS always 
updates the screen contents as it generates the file. 

MISCELLANEOUS 

Several miscellaneous functions complete the kernel facilities of Pico: 

SETFONT ("font-name"). This specifies the character font to use in all 
subsequent DIIAWTEXT calls. The font-name is the name of a disk file 
in "CC" format (standard "CU" fonts may be converted to this format 
with a program described in Appondi.x^). Several standard "CC" fonts 
can bo found on the MAXC <GRAPHICS> directory. SETFONT returns FALSE 
if the specified font file could not bo found; otherwise it returns 
TRUE. 

CHARPROPERTIES (character-code). This function is used to furnish 
details about any character in the current font. It returns zero if 
the character is undefined in the font; otherwise it returns a 
pointer to a vector containing: 

in V>>CHAR.V/IDTH The width of the character in screen 

coordinates. 
in V>>cnAR. HEIGHT The height of the character above the base 

line, 
in V>>CHAR. DESCENT The descent of the character below the base 

line . 

RESETGRAPHICS (). This function should be called before returning to 
the operating system to ensure that the display is returned to its 
normal state. 

INITGRAPHICS ( [frame-space] ). This function initializes Pico. Its 
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siiujlo optional argiinont nay bo usod to croatc a larger or smaller 
run-timo frano space for BCPl. (default value is 1000 dcclnal). The 
function returns a pointer to a table of device-dependent parameters. 
These may bo accessed with the aid of a BCPL structure definition and 
some manifest constant definitions, provided for the purpose. 

V>>PICO.TYPE Type of display device that this version of the 

graphics systen will drive. This will bo equal 
to STDALTO if configured for a standard Alto, 
PnI'\'ALTO if conflgurod for an Alto with a run- 
length codod display device, or COLOR\'OVA if 
configured for the color video system (KOVA). 

V>>PIC0.TAIUJ:T This is TRUE if a tablet is available on the 

nachino in use, FALvSF. otherwise. 

V>>PlCO.XI,r.FT Limits of the screen coordinate system. 

V>>PICO.YBOTTOM 

V>>PICO.XRiGIIT 

V>>PICO.YTOP 

GSTYPKKORM ( format 1 , itcml, format?. , item?., . . . formatn , Item/i ) . 

This routine may be used for general-purpose string output to the 
console. It accepts from one to eight iteni, each preceded by a 
Jo mat in the shape of an integer from to 10. The format number 
indicates how the item is to bo displayed. Formats and 1 treat the 
item as a string pointer and as a character code, respectively. 
Formats from Z to 10 may bo used to print integers to any radix in 
that range. For example, 

GSTYPEFORM(0,"The octal value of ",10, 100, 1,S*N,0, "is ",8,100) 

would generate: 

The octal value of 100 
is 144 

On the Nova, tho output of GSTYPEFORM Is sent to the console; on any 
Alto, it is sent to the system area of the standard display. 

Various pieces of ancillary software are included in the graphics system. 
Those consist of some BCPL packages that Pico uses, and that the user may 
also find useful; 

Free storage allocation. The IMITGRAPHICS call "grabs" a substantial 
amount of available memory for use in building display files, font 
tables, etc. Tho user may make use of the free storage functions at 
any time after tho INITGRAPMICS call has been issued. See Appendix 1 
for documentation on these subroutines. 

Floating point routines. These routines, described in Appendix 2, are 
available for users. Pico takes care to make all of its functions 
transparent to tho contents of tho floating-point accumulators. 
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SECTIO^J III: USE OF PICO 



COMPILINfi AWD LOADIMG 



Before a graphics procjran can be successfully conplled, loaded and run, 
two vital files must bo on the user's disk-pack. These are: 

GSDEFS.SR. This is the source file containing definitions of external 
procedure nancs, structures and constants used by Pico 
progrnns. 

and one of the following: 

APICO.BR. The version of FUco for use with the standard Alto display; 
BPICO.BR. The version for use with Ben Lav/s' run-code display; 
CPICO.BR. The version for use on the Color Graphics Nova. 

A third file is generally essential: 

DEFO^JT.CC. This is the stnndard Alto font in .CC fornat. A font file 
such as DEFO.Vr v;ill bo needed if any text display is 
attempted. Additional font files are available. 

Those files, and all others relating to {'ico, are stored on the <GRAPHICS> 
directory on MAXC. They may ho copied to disk-packs using NEWMCA, MIMX or 
any other path. To simplify the transfer process, three Dump files are 
kept on the <GRAPHICS> directory, containing the essential files for the 
three different displays. These three files, and their contents, are: 

APICO.PM: APICO.BR, GSDEFS.vSR and DEFOMT.CC 
BPICO.UM: BPICO.BR, GSDEFS.SR and DEFOMT.CC 
CPICO.DM: CPICO.BR, GSDEFS.SR and DEFO.MT.CC. 

The procedure for compiling and loading a Pico program is as follows:* 

1. Make sure that the three essential files arc on your disk-pack. If 
they are not, copy (in binary mode) the appropriate .DM file from 
<GFiAPHICS> and type: 

LOAD/V xPICO.DM 

whore x is A, B or C as appropriate. 



* Due to a temporary anomaly, the files APICO.BR and BPICO.BR cannot 
presently be loaded by the Alto Bl.DR. You must therefore substitute in 
their place about twelve separate . 15R files. Those files are for the time 
being included in APICO.DM and BPICO.DM, together with a .CM command file 
for use in loading. The comnand files are called APICL.CM and BPICL.CM. 
After completing steps 1 and 2, you should edit the command file to 
include the name of your program or programs, and then type 0APICL.CM(3 or 
0BPICL.CM3 to invoke loading. V.hcn this anomaly is eradicated, APICO.DM 
and BPICO.DM will be modified to m.itch the description .above. 
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2. Conpilo your source progran. This program should includo the 
statement GET "GSDEKS.SR" at its head. 

3. Load the program with one of the following conmands: 

On the standard Alto; 

BLDR COO/W <your program> APICO IWITALTOIO 

On the run-code display Alto: 

BLOK 000/W <your program) BflCO 1\'ITALT0I0 

On the Color Graphics \'ova: 

BLDF^ GOO/W <your program) CIMCO 101 102 

The C00/\/ switch setting is necessary to increase the space for 
static variables. 



EM F. RAT IMG HARD COPY 

After the program has generated a hard-copy file, the file must be copied 
over to an XGF' and printed. The copying process should be performed with 
the aid of the Ethernet or MCA, whichever is appropriate. To print the 
file (let us say it is called POO.XB), type the following command to the 
XGP Nova: . 

XPLOT POO.XB 

After the usual preamble, the XGP will produce a one-page printout. 
Several file-names may be included in the one XPLOT command in order to 
print more than one hard-copy file: 

XPLOT POO.XB POl.XB P02.XB 

Switches may be used to vary some of the plotting parameters: a number may 
be given in place of the file-name argument, followed by a slash, follov/ed 
by a switch: 

n/E Sets enlargement to n (1,2,3,4; default 1) 

n/L Sets left margin to n (0-1200; default 100) 

n/T Sots top margin to n (0-2000; default 100) 

n/S Sets number of scan-lines per page (default 2000/enlaroeraent) 
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SECTION IV: ADVANCED FUNCTIONS 

Tho functions closcribod in this section nrc not pnrticulnrly difficult to 
uso, l)Ut nro probnl)ly likely to bo used less frequently thnn those 
described in Section II. They fall into four categories: those for 
performing special transformations, thoso for handling input events, the 
DRAWCURVE function for drawing curves, and some miscellaneous other 
functions. 

CURVE DKMilNG 

DRAV/CURVE (x',y',x'',y",x"',y'") 

This function nay be usod in conjunction with HOVETO to draw 
parnnotric cubic curves. [)RAV.'CIIRVE draws a curve from tho present 
(x,y) position throu(jh a locus specified by tho first, second, nnd 
third derivatives of the curve at the point (x,y). Tho curve traced 
out is the locus of (X,Y) defined paranotrically by values of t 
botv/een and 1 in the equation: 

X = X" 't^/0 + X" 'thz + x't + X 
Y = y' ' 't-^/G + y' 't'^/Z +• y't + y 

where (x,y) is the current position. Values of X and Y are 
transformed l)y whatever transformation is in effect, before the curve 
is displayed. The six parameters are pointers to packed floating- 
point numiiers (two-word format). 

Bob Flogal's knot-selection and spline-solving software is available 
(although not within Pico) for calculating derivative values from knot 
lists nnd other representations such as hand-drawn input, or points and 
boundary conditions. 

Note that filled curves can bo specified by calling BEGINFILL, following 
this with calls to MOVETO and DRAWCURVE, and terminating with ENDFILL. 

TRANSFOR MATIONS 

This section describes the primitive transformation functions used to 
implement the DRAW function. Pico maintains a "current transformation 
matrix," a 3x3 homogeneous transformation applied to each coordinate pair; 
it also maintains the pago-to-scrccn transformation parameters, and a 
"clipping region," a region of the screen that describes the limits of the 
visible display. Internally, Pico also keeps a temporary matrix (TM) that 
accumulates the effects of a set of transformations specified with 
TRANSLATE, SCALE and ROTATE. V/hen a graphical primitive is called, tho TH 
is postmultipl ied by the current transformation matrix and the result 
replaces tho current transformation matrix. 

SETMATRIX ( pointer-to-3x3-mntrix) . Sets tho current transformation 
matrix from the matrix specified by the pointer. Wtienovor a now 
segment is opened, the matrix is automatically sot to the identity 
matrix. Tho matrix is stored in packed floating-point format. 

SAVEMATRIX (). Saves the current transformation matrix on a stack» and 
sots tho TM matrix to the identity matrix. 
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KF.STORF.MATRIX (). Restores the current transformation matrix from tho 
stack. 

TRANSLATE ( trnnslation-x, translntion-y ) . Postmultlply the TM by the 
matrix spocifyincj translation throurjh ( translation-x, translatlon-y) . 

SCALE ( sx [[,sy],sw ] ). Postmultiply tho TH by the matrix specifying 
scaling hy factors (sx/sw, sy/sw) . If sy is omitted, the scale 
factors are sx/sw in both directions; if sy and sw are omitted, the 
scale factor is sx in both directions. 

ROTATE (rotation-ln-dogrocs). Postnultiply tho TH by a matrix 
specifying rotation throufjh the specified angle about the origin. 

COS ( intogcr-dogrcos) . This function returns, in floating-point 
accumulator 1, the value of the cosine of the nngle specified in the 
call. 



The above functions are used in transforming information into page 
coordinates. As explained in Soction II, tho SF.TWINDOW function may be 
used to select a rectangular region of the page for display on the screen. 
Pico in fact allows control not only over this window, but also over the 
vicmport , a rectangular region on the screen onto which is mapped all the 
Information lying within tho v/indow: 

SETVIKWPORT (xlof t ,ybottom,xright,ytop) . This function specifies the 
limits, in screen coordinates, of the viewport within which 
subsequent graphical information is to be displayed on the screen. 

Thus SETWINDOW effectively says, "show me this much of the page", and 
SETVIKWPORT says, "show it to mo in this region of the screen". The 
SETWINDOW and SEIVIEWPORT functions should bo called before creating the 
display file segments on which they are to operate, much as SETV/INDOW is 
called at the start of the example on page 14. Several different 
viewports may be used in generating one display, thus: 

LET MAINO BE [ 
IMnT.RAPllICS( ) 

SETWINl)OW(wxll,wybl,wxrl,wytl) // set first window 
SETVIEWPORT(vxll,vybl,vxrl,vytl) // and first viewport 
OPENSEri(k) 

// define first part of picture 

POSTSECid) 

SETWINl)0W(wxl2,wyb2,wxr2,wyt2) // set second window 

SETVIEWP0RT(vxl2,vyb2,vxr2,vyt2) // and second viewport 

OPENSECi(m) 

// define second part of picture 

POSTSEO(n) 

UPDATE() // update screen 
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INPUT 

It is not always possible to predict which device will next nonerato an 
inpvit to an interactive profjran. The user may typo on the koylioard, point 
with the stylus or drnw a stroke. The READPOSITION, READSTROKF. and 
IU-X0GNIZF> functions described in Section II are designed for applications 
whore one can predict the order in which inputs occur. In cases whore tho 
order of inputs Is not known, it is necessary to use a more ncncral sot of 
ininit routines that handle events. Thnse routines collect events from tlio 
input devices and store then in a rnieue in their chronological order of 
occurrence. The program nay call functions to wait for the next event to 
arrive in tho queue, to determine what sort of event it v/as, to read the 
input data, and to delete the event from tho queue. 

An event is any one of the following: 

1 . A keystroke ; 

2. A stroke, generated by pressing and releasing the stylus or mouse 
switch; the device may or may not bo moved while tho switch is 
depressed . 

3. A timeout event: tho timer is always started on completion of a 
stroke, and stops either when it times out, or v;hen another stroke is 
completed, whichever happens first. In the latter case, no event is 
generated. On completion of timeout, the character recognizer 
attempts to recognize all tho strokes in the queue. If tho queue is 
empty of strokes (i.e. stroke events have been deleted as they 
happen), no event is generated; otherwise the recognizer's best guess 
is returned in the event data. 

V/honovcr an event occurs, all events of other typos are automatically 
deleted from tho queue. It is therefore unnecessary to delete events 
except to prevent invocation of the recognizer. 

Tho following functions are provided for event-handling; 

GETEVF-NT (). This function waits until the next event occurs, and then 
returns to tho program a vector, V say, containing in V>>EVENT.TYPE 
tho typo of event (1, 2 or 3 as above). According to this value, the 
rost of V contains: 

if V>>EVENT.TYPE equals 1 (keystroke): 

V. .EVENT. CODE the ASCII code of tho character; 
V>>EVENT.KEYS four words containing tho status of the 

keyboard, in Alto format. 

if V>>EVEMT.TYPE equals 2 (stroke) or 3 (timeout): 

V>>EVENT.CODE the code of the recognized character, an 

eight-bit integer on which tho recognizer 
has previously boon trained (seo Appendix 
3); zero in type-2 events. 
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V>>i:VF.MT.XLF.FT 
V>>r.VI.MT.VnOTTOM 
V>>F.VF.NT.XRir.MT 
V>>EVENT.YTOP 
V>>EVEWT. INKED 

V>>EVENT.CONF 

V>>EVENT. STROKE 



V>>EVENT.. SWITCH 



) thn coordinatos of tho hotton left and 

) top rifjht corners of tho rectangle 

) surrouncling tho stroke or strokes; 

) these are In screen coordinates . 

TRUE in tho case of an inked stroke, FALSE 

otherwise; 

Confidence (0 to 100) with which the 

character wns recognized; 

Pointer to stroke vector, in screen 

coordinates , stored as in Figure 8; typo-3 

events return a vector, in identical 

fornnt, containing the coordinates of the 

stroke centers. 

Switch number (tablet always returns 1). 



PELETEVEWT ( ) . This function deletes the nnst recent event, 
events remain in the event queue, this function has no effect. 



If no 



CLEAREVEMTS (). This function clears tho event queue of all events. 

SETI.VPUTPARAMETERS ( tinoou t- intervn 1 , ink-tolerance, sample-interval ) 

This function may be usetl to modify parameters controlling cvent- 
handlinfj. It specifies the timeout interval for character 
recognition, in milliseconds (default is 1000), the distance to be 
moved by the stylus or mouse l)efore inking begins (default is 4 
screen units), and the minimum distance between points recorded in 
tho stroke vector (default is 4 screen units). If any of these 
arguments are negative, the default values are inserted in their 
place. 

SCREENTOI'AGE (scroenx,screeny,po inter-to- pa gex, pointor-to-pagey) . 

This routine may be used to convert coordinates back from screen 
coordinates to page coordinates; it uses the most recent window and 
viewport settings. The third and fourth arguments should bo pointers 
to two locations where the page-coordinate equivalents of the first 
two arguments are to be stored. 
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Appendix 1: Free Storage Routines 

A froo-storago package is provided as an integral part of Pico. The 
packago provides the following procedures for allocating and releasing 
variable size blocks: 

INITFREESTORE (S). 

Organizes the free storage space as one large block of size N, such 
that frann space of S v/ords is if possible made available. 
INIlTFRKKo lORE sets up the appropriate globals: 

FIRSTBI.OCKrpointor to first block, 

LASTBLOCi;: pointer to last block, 

AVAILMAX: naxinun size of available block (see GETBLOCK), 

AVAILTOTAL: total size of free space. 

The last two variables are declared external in GSDEFS.SR. 



INlITFREKvSTORK returns the actual 
initial sotting of AVAILTOTAL. 



size of free storage, i.e. tho 



GETBLOCK (M). 

GETBLOCKA' (M). 

Returns a pointer to the fir?! fre e word of a block of size N. N is 
tho actual number of usable words. Tho actual size of the block will 
bo between N and li*E, so tliat no blocks of size smaller than £ -- a 
small number -- will exist (if hi<E, N is set to E). 

GETBLOCK and GETBLOCKX differ in the way error returns arc handled. 
GETBLOCK returns (i.e. FALSE) if no block of size N is available. 
The global AVAILMAX will then contain the size of tho larger 
available block. Notice that the content of this location is only 
meaningful in this context. It is up to the caller to verify the 
value returned and decide whether to call again with a smaller value 
(smaller than AVAILMAX). GETBLOCKX will instead print a message and 
exit. 

GETBIGBLOCK (N) 
GETBHiBLOC»;X (N) 

Returns the biggest block 

as explained above. 



of size greater than N. Error returns are 



PUTBLOCK( BLOCK-POINTER) 

Returns a block to free storage, merging it into a larger block If 
possible. Also checks that the boundary tags are correct. The 
argument should be a pointer previously returned by GETBLOCK or 
GETBIGBLOCj;. 



TR I MBLOCK(BLOC»:- POINTER. FREE- VORD- POINTER) 

Returns to free storage the unused words at the end of a block If 
there are more than E of then), and resets the boundary tags. The 
first argument is the usual block pointer; tho second argument is a 
pointer to the first unused word of tho block. 
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Tho Trco stor.Kjo allocation proccduros uso tho "boundary tag" tochnlquo 
(Knuth, vol. /l, p.iM35). A froo block of storage is structurad as 
follows: 



- (N'*2) 



rerun T'l pointer 



back pointer 



(N-2) 
la^ords 



- (N*2) 



A rosorvGd block, looks liko: 



Figure 10 



field re ss 




Figure 11 
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Appendix 2: Floating-point Routines 

The f lontinn-point routines described below will run on a standard Alto 
(<GRAPHICS>FLOATALTO.BR) or on a MOVA (<GRAPinCS>FLOATWOVA.BR) . 

Thoro aro 16 floating-point accumulators, numbered 0-15. Each stores a 
iC-bit binary exponent and a 32-bit mantissa. These accumulators may be 
loaded, stored, operated on, and tested with the operations described 
below. 

Conventions for the description: 'acnunber' refers to an accumulator 
number (0-15); 'arn' is either an accumulator number (if 'arg' < 10) or a 
pointer to a packed (2-wor(l fotn.it) floating point number; 'ptr-to-fp- 
number' is a pointer to a pncked (?.-Kor(i format) floating point number. 
If a function returns a value, the symbol " = = >" is used to show the 
result; functions that do not have the "==>" following them return their 
first argument as a result. 

FLD ( acnumber , arg) 

Load the specified accumulator from source specified by arg. 

FST (acnumber, ptr-to-fp-number ) 

Store tlie contents of the accumulator into a 2-word packed floating 
point format. Error if exponent is too large or small to fit into 
the packed representation. 

FTR (acnumber) ==> integer 

Truncate the floating point number in the accumulator and return the 
integer value. Error if number in ac cannot fit In an integer 
representation. 

FLDI (acnumber, integer) 

Load-iminediate of an accumulator with the integer contents (signed 
2's complement). 

FNEG (acnumber) 

Negate the contents of the accumulator. 

FAD (acnumber, arg) 

Add the number in the accumulator to the number specified by arg and 
leave the result in the accumulator. 

FSB ( acnumber , arg) 

Subtract the number specified by 'arg' from the number in the 
accumulator, and leave the result in the accumulator. 

FML (acnumber, arg) [ also called FMP ] 

Multiply the numl)er specified by 'arg' by the number in the 
accumulator, and leave the result in the ac. 

FDV ( acnumber , arg) 

Divide the contents of the accumulator by the number specified by 
arg, and leave the result in the ac. Error if attempt to divide by 
zero. 
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FCM (acnunl)or,nrg) = = > intofjcr 

Conparo tho nunhor in the ac with the number specif iod by .'arg'. 
Return 

-1 IF ARGl < ARGZ 

IF ARGl = ARG 2 

1 IF ARGl > ARG2 

FSW (acnunbor) ==> integer 

Return the sign of tho floalina point niinbor. 

- 1 if si (in nocjativo 

if value is exactly (quick test!) 

1 if sign positive and number non-zero 

FLDV (acnunl)er, ptr- to- vector) 

Read the 4-eloinont vector into tho internal representation of a 
floating point number. The ^-word vector is arranged as follov;s: a 
word for sign (-1 moans negative; positive), a word of signed 
exponent; two words of mantissa. 

FSTV ( acnumber , ptr- to-vector) 

Write tho accumulator into tho 4-olement vector in internal 
representation . 

Tho 2-word packed format is: 

The first word is: 

sign -- 1 bit 

exponent -- excess 120 format (8 bits) 

will be complemented if sign negative 
mantissa -- first 7 bits 

Tho second word is: 

mantissa -- IC more bits 

Note this format permits packed numbers to be tested for sign, to be 
compared (by comparing first words first), to be tested for zero (first 
word zero is sufficient), and (with some care) to be complemented. 

If you wish to capture errors, put the address of a BCPL subroutine in the 
static FPerrprint. The routine will be called with one parameter: 

Exponent too large -- FTR 

1 Exponent too largo -- FST 

2 Dividing by zero -- FDV 

3 Ac number out of range (any routine) 

Tho floating-point routines use a work area, pointed to by the static 
FPwork, for storage of all accumulators, etc. The first word of that area 
is its length. If FPwork is changed to point to another work table of 
adequate length, the subroutines will use it for working area. This 
permits subroutines to save and restore the contents of tho floating-point 
accumulators. 
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Appendix 3: Training the Character Recognizer 

A program called TIIAINER has boon written to enable users to sot up files 
for the rGCorjnizor. The conpilnd version of this program, suitable for 
use on a standard Alto, is TRAIMER.DM (a dump file) on <GRAPHICS>. 

To start the program, typo TRAINER. You will be asked if you want to add 
to an cNisting file: if so, typo the file name, followed by <roturn>; if 
not, just typo <roturn>. Then a display will appear similar to the one 
overleaf, and you will bo asknd to draw a character. 

Every time you (h-aw a character, TRAI\'ER will try to recognize it. If It 
fails, it will say so, and you r.hould point to the letter that corresponds 
to the synhol you tlrew. If it succeods, you nay point an^ns-hcrc to confirm 
correctness. If you wish to train to a character other than an upper-case 
letter, point to the characli'.r and then give the required octal value. 
If you draw an inaccurate s^inbol, you may reject it by pointing to the 
"rej" syri])ol. 

The three targets at the top of the screen are to bo used to clear the 
screen of ink, to file the results of a training session, and to exit from 
TRAINER. 

As training proceeds, largo amounts of nomory may bo used up. You can 
compact by v/riting out a file, then starting TRAINER again and reading in 
the file. You should do this if areas of the screen become unreceptivo to 
ink. 

WRITING YOUR OWN TRAINER 

Three special functions exist, in a file called GSTRAIN.BR on <GRAPHICS>» 
that may be used in the construction of training programs. These three 
functions are: 

INSERTPROPS (). If called after calling RECOGNIZE or after receiving a 
ty|ie-3 event, this function saves the properties used by the 
rccoqnizer. They may later be inserted in the tables by means of the 
INSERTCODE function. 

INISERTCODE (code). This function enters into the recognizer tables the 
properties saved by INSERTPROPS, identifying them with the specified 
eight-bit code. 

WRITEPROPTAB (filename). This function writes out the recognizer tables 
onto a file of the specified name. 
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exit clean file 



©ABCDEFGHIJKLMNOPQRSTUVHXYZrej 



Figure 12. 
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Appendix 4: Creating .CC Font Files 

Font descriptions In a format accoiitable to the graphics system (hereafter 
called CC format) can bo created from any font in ".CU" format. All fonts 
currently created at PARC are available in this format (consult Ben Laws, 
or the <LAV/S> directory on MAXC, for available styles). A LISP program is 
used to create CC files from this format. The dialog below illustrates 
the uso of this program (characters typed by the user are underlined): 

PL ISP 

INTERLISP-IO xxxx 

Good afternoon, faithful. 

^LOAD ( <GRAPHI CS>C HA 1 N . C OM ) 

CI!AIWr\'S • 

Filonaru! in .CU format to be convci'ted . . . . GACH A.CIJ 

GACHA.rU;! 

Filonann for .CC version. . . . GACHA.CC 

GACIIA.CC;! 

Baseline for this font ....A 



<prints each character code in decimal as it is procossod> 
0G01JT( ) 



-I 

If error messages are generated, consult the Graphics Group. 
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Appendix 5: The XPLOT Filo Structure 

An .XB file consists of n hjiailc^_r, rollowod by n texture t able , followed by 
any nurnhor of scnn -l Ino-s tro nns . Each scan- line is processed in order of 
its appearance in the file, from top to bottom of the page. 

The header is a 4-word block, that specifics: 

word 0: cnlargonont (1) /E 

word 1: left narcjin (100) /L 

word 2: top margin (100) /T 

word 3: scan-lino-stroams/pagn (2000/enlarnenont) /S 

Those specify the coordinates (in XdP resolution units) of the upper left- 
hand collier of the picture;, the rnlarncMUMit (intoner from 1 to 4), and the 
number of scan- lino specifications in the file that should fall on one the 
XGF' page. • If an entry is zero, it is replaced by the default listed in 
parentheses. The entries may also be overridden by switches specified in 
the command line. 

A texture table is a count, n, followed by Zn words. The first n are 
called the T table, the second n the W table. 

A scan-line-stream is a count, n, followed by abs(;j) words of either run 
or bit-map data. If n 0, the words arc interpreted as bits to bo given 
to the the XGP (high order !)it of a word appears left-most on the page). 
If n > 0, the words are interpreted as runs: each word specifies a pattern 
(H) and a run (R). The high order 8 bits are H, the low order R. The 
idea is that the pattern specified by H will be repeated for R bit 
positions on the scan-lino. The next (H.R) pair will pick up where the 
previous loft off. 

A run is specified by H and R as follows: M is an index into the T and W 
tables. T[n] is a bit sequence to send to the the XGP; W[H] is the width 
(or modulus) of the bit sequence (must bo between 9 and 16 inclusive). 
The algorithm for displaying runs (at enlargement 1) is: 

while R W[H] do begin 

show the high-order W[H] bits of the pattern T[H]. 

R *- R-W[H] 

end; 
if R neq then show the first R bits of tho pattern T[H] 

Note: for increased efficiency, H=0 always corresponds to the blank, 
sequence (i.e. white space on the the XGP). 

Handy constants: an the XGP page is about 1300 dots across and 2100 scan- 
linos long. Horizontal and vertical resolutions are thus about 200 dots 
per inch. 



